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The purpose of this bulletin is to present an overview of the record 
control byte (RCB) and to describe its use in several 0S/3 program 
products. A general knowledge of 0S/3 is assumed. 


OVERVIEW 


The presence of a ROB ina file allows the user to logically delete 
records from MIRAM data files by marking them as void records. The 
marking process consists of setting the high order bit in the RCB. 
The records are not physically removed from the file. 


If the records are fixed length, the RCB is prefixed to the front of 
each record. If the records are variable length, the third byte in 
the 4—-byte overhead is used as the RCB. 


The presence of a RCB when retrieving records is transparent to the 
user. Therefore, the following statements hold true no matter whether 
the program product that is accessing the file uses the RCB or not. 


e I£ records are retrieved sequentially, the deleted records 
are skipped over. 


e If records are retrieved randomly and the search argument 
specifies the key or relative record number of a deleted 
record, the result is a no-find error condition that is 
passed by data management to the program product. 


USE OF RCB 


The following table describes which program products use the RCB to 
legically delete records and the RIB default at file creation time. 
(The RIB (resource information block) macroinstruction is used 
internally to describe the file characteristics and processing 
requirements.) Further information is discussed in the comments. All 
information is common to both Release 7.1 and Release 8.0 except as 
noted in the comments. 


Program products that use the RCB to delete records can access files 
that do not have a RCB; however, records can not be deleted from these 
files. 





PROGRAM USES RIB 
PRODUCT RCB . DEFAULT COMMENTS 
ASM YES NO To change the default, specify 


RCB=YES in the RIB macroinstruction. 


BASIC NO NO 
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PROGRAM 
PRODUCT 


COBOL 


ESCORT 


FORTRAN 


USES RIB 
RCB DEFAULT 


YES See 
comment 


YES YES 


NO YES 


NO NO 


See See 
commentl comment2 


COMMENTS 





Relative and indexed files are created 
with a RCB. For compatibility, COBOL 
assumes the RCB to be present for 
sequential files and allows for it in 
the block size. However, sequential 
files created by COBOL have no RCB. 


FORTRAN can net process files that do 
not have a RCB. 


In Release 7.1, files containing a RCB 
can be accessed if the block length 
calculated by RPG or specified in the 
file description specification form 

is at least as large as the minimun 
allowable value. (See Consolidated 
Data Management Macroinstructions, 
UP~8826, Section 2.3.1 for the 
algorithm for determining the minimun 
allowable value.) In Release 

8.0, a new source statement allows REG 
to access files that have a RCB and to 
create files with a RCB. Specifying 
‘RCB' in columns 54-56 of the file 
specification continuation statement 
allows RPG te calculate the correct 
bleck size for files that have a RCB. 


l. In Release 7.1, IMS does not use 
the RCB. Qly legical deletions 
(setting the first byte of non-key 
data in the data portion of the file 
to hex 'FF') are allowed. This 
deletion is recognized only by IMS. 

In Release 8.0, ‘physical' deletions 
(actually a logical deletion by setting 
the RCB) are allowed by using the 
DELETP parameter. The default for this 
parameter is YES for multikey files, 
NO for single key files. 


2. File characteristics must be defined 
by the user before the file can be 
accessed by IMS. IMS does not create 
file characteristics. 
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PROGRAM USES RIB 

PRODUCT RCB DEFAULT COMMENTS 

EAE, bow ne f sooo Pee + 6: «= > 4 

COPY NA NO To change the default, specify RCB=YES. 
DATA NA See The default is the input file 

UTILITIES Comment characteristics. To specify no RCB, 


specify the CM or OMY parameter as 
follows: OM=(,,,R) or OMY=(,,,R). 


EDr NA NO To change the default, specify RCB=YES. 


NA = not applicable 


